ATTR Syntax: Attr filename [perroissions] Usage : Examine or 
chani^e the seouritj permissions of a file Opts; -perm = turn off 
specified Dermigsion nerm- turn on specified permission -a = 

rms : d - directory file 
to owner w - write permit 



inhibi 
s - nc 
to 0^1 

pw - ^ 

Syntai 

one d( 

single 

BasicO 

filenai 

CHD S; 

specif] 

dlrecto^7""tS 

Usage ; Fi||:;i^©B(jjJ8|jsis 
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PP read permit to public 
Hiipermit to public BACKUP 
pi Copies all data from 
sil error occurs s = 
iilites BASIC 09 Syntax : 
piBUILD Syntax: Build 
|i||i|rom standard input 
IHP working directory to 
iilisaee; Change execution 
ii| nlenamel filename2 
ilipitax; Cobbler devname 
tJsage : CrMtes 13S-9 nDootstFa^^^^^^^^ current boot CONFIG 

Syntax r"^—^- ^^ ^— " *— ^ ■• * - ■ " ■ ' " -^ — p disks COPY 

data from 



Syntax 
one fil 
Date [t 
specify 
: Checl 
for woi 
= save 
cluster 
print ( 
Kdevn 
rilenan 
delete 
directo 

names 
executi 



EDITOR : 
Gordon Bentzen 
8 Odin Street 
SUNNYBANK Qld 4109 

(07) 345-5141 



fe]§yntax : 
llllfa: t = 
^^> Usage 
"ictory 
^..^.l^s -m 

IB-o = 

i&iame> 

iiiei [-x] 

i^eldir 

»ppax: Dir 

iH file 

Mi|[=pnnt 



to copy all fSes in a mrectory system Opts : --b make a system 
disk by using OSQboot if present -b=<path> = make system disk 

liaiinrr nal'K t*^ — firhinfiArt ,. ,.A i iia Jai^I- — ^*** -^ni^n nf^i--" l^-^^lfn 1 m^ /1q Tint 



using path 
process b 
command 
ECHO Syn 
output EE 
text editcL 
error mess- 
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i-I-v-ij— ifC--"' 



y^^f^^^^PTHF 



Ifl^ ttTT!;** jrtprsz.: 



makdir 
ftsaum K 

iMard 
Unted 
Msiixt 
aame> 



Usage : Chain W'tlS^-'lif ePltto^wfl€i^'---F^ 

<devname> Usace : Initializes an OS-9 difjkette Opts ; R - Ready L 

- Logical format only "disk name" 1/2 number of sides 'No of 
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SUPPORT : Brisbane QS3 Level 2 User Group. \/ ^ H ' / iJ GROUP 

y'elcoiBe to the Hay edition of our iBonthly newsletter, ye again appeal for your coaeents and for subisissions to be 
included in future editions as this newsletter is intended as the newsletter of the 0S5 user group, 'h continue to 
try to present articles which will be useful to OSS'ers at ail levels of experience. 

I have had a few queries over the last couple of ritonths froa ae^sbers who have just begun the venture into QS3 and 
Dredictably are having soae difficulties, so I have decided to cotssence a series, 'OS-S Frofs The Beginning^ which 
15 diaed at the new OSS user. Bob Devries often reainds ae that 'it is all in the sianuaT when I ask a question at 
our local user group aeeting. yhilst this is no doubt true; i sees to avoid reading the aanual unless it is alsost 
a last resort. The 0S9 aanual after ail can be a little daunting to begin with^ so I hope to guide the new user 
through the learning curve with several references to this aanual. 

Bob Devries had a call froa Hike Haaland, author of ilVCanvas, of Las Vegas, Nevada, this week and gleaned soae aors 
■irst hand inforaation about the KLE (Kenneth-Leigh Enterprises) 'CuCo4'. It has a 68070 (Signetics) CPU, 2 HByte 
RAH, 1.44 HB 3.5 inch drive, and QS9/63000 kernel in ROH. Hike Haaland is one of the software developers for the 
new aachine, so we should see soae nice software for it. The new aachine is already being produced, and the firsi 
batch will be given to software developers only, and the cosiDuters will be available for purchase in August this 
year. 

Hike also aentioned that version 2 of ilVCanvas is ready for shipping, and should be available frora Nickoias 
"iarentes by the tiRe you read this. Purchasers of version I will be able to buy an upgrade for approximately 
115.00, and the new price will probably be $50.00. Contact Nickoias Harentes for sore details. Also read the review 
in the Harch 'SO issue. 

An interesting opportunity caae to Don Berrie recently, when he was able to get lifiiited access to a iaainfrasie 
lOiFiDuter which had access to Bitnet. a global information network. It is this network which has provided the 
^latenal about the new coaputers which we have published recently. Those files, of course were kindly orovided by 
"eter Edwards, one of our inesbers froa Heibourne. Also available on this network, are a large nuisoer of puoiic 
joaain and shareware prograsiaes, but in a strangely encoded fors to sake theei transaittable as textf ile-like 
electronic iail. 

Don has aanaged to 'download' soae of these fiies, and is m the process of decoding thea. In due course, they 
will be aade available as part of the National User Sroup public doinam collection. The usual conditions for 
copying will apply. 

One of the things which Don has downloaded, is an archive which provides patches to both the SRFDRV and SSHELL-*- 
=Tiodules, to enable the@ to run faster. When installed, these patches really sake the flultiview environsent fly. 
In fact, Don has tised aultiview drawing a screen full of icons (fors his coaaands directory) at 1.2 seconds. This 
lOfflpares with 2.S or so seconds with the unpatched versions. There is really still soiae life left in the old 5803 
vet! ! 

Cheers, Gordon. 
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D o c u rae n t a t i o n f u r SAP. 

The fol lowing progr amine is what could be described as a * home- 
made' disk editor written expressly for the Color Computer 3 and the 
OSy Level II operating system. Copying by any method, including 
posting on electronic Bulletin Board Systems, for personal oi^ 
educational use is encouraged. Copying for commercial purposes, or for 
sale or resale is expressly forbidden. 

The following equipment and software utilities (which may be 
the proprietory property of other software/hardware vendors) are 
required to successfully operate the programme: 

HARDWARE 

1. 512K Tandy Color Computer 3 

2. OS9 Level II Operating System 

3. High Resolution Monitor 

(The use of a colour monitor is advantageous, but not essential) 

SOFTWARE 

The programme needs, at various times during it's execution, access to 
the following system modules or commands: 

RunB, Syscall, gfx2, shell, xmode , dir, /? or /PI and /V 
Syscall needs to be merged with either Gfx2 or RunB to allow RunB to 
find it. 

The programme requires an unused window descriptor in which to run 
itself. 

To use the programme, copy it to your current execution directory, 
and at the 0S9 prompt, type ZAP. 

-WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING- 

W This programme performs low level read and write operations W 

A on RBF devices. Use with extreme care. Do not use on media A 

R which is irreplaceable. If you do not understand what a R 

N programme of this nature is used for, do not attempt to use N 

I it. Sector copies, including those from one device to another I 

N are permitted. However use extreme care, as the sector N 

G allocation tables are not updated during this operation. G 

-WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING — WARNING- 



This documentation should accompany all copies of the programme, so 
that users have access to the address of the authors for advice and 
comments. This project has been supported by the Australian National 
0S9 Users Group. 



Page 3 May 199 



AUSTRALIA]^ 039 IfEVSLETTER 



PROGRAMME USAGE 



The programme is started from the command line by simply typing '*ZAP" 
with no arguments. The introductory banner is then displayed, together 
with a warning, and the user is prompted to input a device name. 
The device name entered is checked for validity, and if valid, an 
attempt is made to read LSNO of the media currently associated with 
that device. 

If LSNO can be read, the media size bytes are decoded, and the 
user is prompted to enter a sector number. The programme will 
not accept sector numbers larger than the maximum number read from 
the media or less than zero. As soon as an acceptable sector number 
is input, that sector is output to the screen in a matrix 
comprised of 16 rows by 16 two-character bytes, and a menu is 
presented at the bottom of the screen. 

The following list describes the menu items in alphabetical order. 

A - Toggles on and off an ascii decoding of the current 
sector. Only printable ascii characters are printed, 
Non-printable characters are represented by a * . ' 
character. This ascii mode remains in force until a 
further 'A' is entered to turn it off. 

C - Switches on a simple calculator in an overlay window. The 
calculator only accepts input of the following keys. - 
9, A - F (shifted or unshif ted) , the +(;)->;(:)/ and 
<ENTER> keys. The user may optionally use the <SHIFT> key 
for + and ^. The calculator always expects input in 
hexadecimal mode, however the decimal equivalent of the 
calculator is displayed in the bottom half of the overlay 
window. To exit from the calculator mode (at any 
time, even in the middle of the calculation) simply press 
the <F1> key. 

D - Prompts for a change of current device. If the programme 
cannot open the new device, or attempts to open a device 
with a media error, it will terminate and display the 0S9 
error number which caused the problem. Vhen a new device 
is selected, LSNO is read, and the programme again prompts 
for a valid sector number. 

E - Provides access to the 'dir* command to do an extended 
directory of a chosen device. The user is prompted to 
supply a (full) pathname to the directory required. 

H - The help command provides the user with an overlay window 
that shows a (greatly simplified) summary of all of the 
meanings of the individual menu keys. 

I - Shows, in an overlay window, the plain language decoding 
of LSNO for the currently selected media in the current 
device . 

M - WARNING! The ' M' command is used to modify the contents of 
the current sector. These modifications are performed 
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initially in ineraary. When this corainand is selected, a new 
menu is shown, and a cursor appears on the data area of 
the screen. The cursor is steered around the data area by 
the use of the arrow keys. It operates on the 'closed 
system' principle. That is, if the left arrow key is 
pressed when the cursor is located at byte 0, the cursor 
will jump to byte 255 and vice-versa. The ' V key is used 
to rewrite the current sector, and the user is prompted to 
verify the operation. Pressing *H' while in modify mode 
will provide a simplified tielp screen. The sector 
modification routine only accepts pairs of hexadecimal 
numbers, and moves to the next adjacent position after 
each pair of numbers is entered. If the ascii switch is 
toggled on, changes to the sector are NOT shown in ascii 
until after the new data is written to the media. It is 
possible to change any data in any sector on the disk. 
This may make your disk unreadable, or destroy a directory 
or file, or cause an executable file to have a CRC error. 
Be careful ! t 

N - The * N' key is used to select a new sector on the current 

media. O^ily valid sector numbers are accepted. When a 

valid sector number is entered, the sector data is redrawn 
to show the contents of the new sector, 

P - To print a hard copy of the current sector use the 'P' 
command. The programme will look for the device /PI to 
use to print the sector data. If /PI cannot be found, 
the programme will then attempt to use the device /P. If 
the printer is connected, but offline, the user is 
prompted to place the printer online, and to retry. If 
no printer is connected, then (because of a hardware 
feature of the CoCo 3) the programme appears to see a 
printer and passes the data to the printer port. As 
soon as all the data is passed, the programme is ready to 
accept further input. 

Q - Press the *Q' key to exit the programme. On a successful 
exit, all windows and devices are closed, all of the 
programme modules removed from memory, and the user is 
returned to the original screen from which the programme 
was run. In most cases, pressing the <BREAK> key will 
also terminate the programme without messing~up the 
system. 

S - WARNING! This command allows sectors to be copied, either 
from sector to sector on the same disk, or to media in 
another device. Be very careful when using this command. 
The sector allocation table is NOT updated by this 
operation. The user is prompted for verification before 
performing a low-level write. This operation may overwrite 
some of the vital contents of your disk, and make part or 
all of the disk unusable! ! Be very careful. 

- -> - The left and right arrow keys are used to move to the next 
or previous sectors. When located at sector zero, pressing 
the left arrow will cause the highest numbered sector on 
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the disk to be displayed. Similarly, pressing the right 
arrow key when located at the raaxiinum sector causes sector 
zero to be displayed. If the ascii toggle in on, the new 
ascii data is written after each sector change. 

When expecting input from the users console, the programme 
will accept both lower case and upper case letters. If the programme 
terminates with an error condition, an attempt will be made to 
identify the particular error which caused the termination. It may be 
necessary to press the escape key to finally return to the 0S9 
prompt in these circumstances. Extensive error trapping has been 
incorporated into the programme, however, so as to make as few 
assumptions as possible about a user's particular system, we have 
decided not to try to use error number decoding (by looking for 
/dd/SYS/errmsg etc). 

The programme has undergone a number of substantial revisions 
since the BasicOQ source code for version 1.10 was published in the 
Australian OS9 Newsletter, and a number of major problems have been 
rectified. The programme will work equally well with hard, floppy, 
or ram disks of any size, and all necessary disk data is always read 
directly from the media in question. Extensive debugging and testing 
has taken place, and as far as we know the programme has no major 
bugs. Further development is contemplated, however new releases will 
be written in ' C , and will be of a more generic nature. 

If you feel that this programme will be useful, and will help 
get you out of trouble, please send $10.00 to give us the incentive to 
keep support for ZAP going, and to keep working on new versions. 
Feedback from users is encouraged, and may be directed to : 

Don Berrie Bob Devries 

25 Irwin Terrace 21 Virgo Street 

OXLEY Qld 4075 INALA Qld 4077 

AUSTRAL I A AUSTRAL I A 

<07) 3753236 (07) 37278ir3 
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OS-S FROH THE BEfilNNINfi 



Ue have presented £ nuBiber of articles in our newsletters designed to help others gain an understanding of this 
operating systes, refer to the Newsletter Index in last fftonth's edition. 

For this series I will assufie the reader has a Tandy CoCoo and the Tandy OS-3 Level 2 operating systes. I will 
also fissuae that the reader tiiay have venturec into the Hicroware GS-9 package only to decide that it seens very 
unfriendly and difficijlt to understand. Perhaps it is tifije to retrieve the two CS-S disks froiK the disk box and 
the fianudl fros the bottom drainer. 

1 have used a Tandy I, 2 and 3, and like sany others.: became reasonably faailiar with the built in Basic, Extended 
Basic and then Disk Basic. Ue can run iany co&Riercidl progra^^s, and even write our own in Basic or assesibiy 
language, load files and save files using floppy disks and do mw-/ other interesting things; so why OS-S? 

OS-S is an operaiing systefi, unlike Disk Basic (soisieii^ies referred to as RS-DOS) which is strictly not an operating 
systei? at all, so the very first thing to do is to forget all the Disk Basic coBiiiiands Decause the disk access 
comijiands are only an extension of BASIC. The one coiitsiand exception is '-DOS' which is a disk Dasic comsand used to 
start-up OS-9. 

The Hicrotfare CS-3 operating system, once booted, will replace Disk Basic in the cofiiDUier's seaory. All 
descriptions of hardyare deviceS; eg. disk drives, serial pori, etc, which were "built in' to RS-DOS, are mv gone. 
So for CS-S to use the hardware deviceS; it needs a description of each and every device connected to tne systejrt. 

DS-9 has been modelled on Mil, has a great sisiilarity to UNIL and tfill bring a UNIX feel to your favourite 
computer. This is EiSinly due to the coBUnon concept of "Hodules'' and unified I/O (Input/Output). OS-9 is (siade up 
of over one hundred si&all programs or utilities, each designed for one Sffiall job and referred to as a "Hodule". To 
add a ne^ device to OS-9, Just describe it to the operating systeei. Each device needs a 'device driver" and 
"device descriptorV yhile each separate device needs its own "descriptnr\ like devices are able to share the 
saiiie ''driver% eg CCSDisk is the "driver" for floppy drives, and DO, Dl, 02 are the "descriptors' for each physical 
drive which each share the CCSDisk driver. OS-9 also uses special class drivers. In OS-9 jargon, a floppy disk or 
hard disk fall into the special class called 'Random Block File" (RBF) devices. However, itiore on that at a later 
stage. 

The point being that the soduiar concept of OS-9 allows EACH device to have a unique description. Drive (DO) fiiay 
be 35 track single sided, Drive 1 (Di) stay be 40 track double sided, Drive 2 (D2) say be 80 track double sided, or 
in fact any coiiibination desired. Each such device ifiust of course have a "descriptor'' which aatches the physical 
device. 

FIRST, take the OS-9 t&anual and read the first section "Setting Started". Now don't be teepted to go further into 
the next sections, but read "Getting Started" again. Don't worry if it does not all sake sense at this point. 

The "Getting Started" section lists hardware requirements as a CoCoS (presuaably 128K) and one floppy drive. OS-9 
on such a systes is yeeerrry lisited and painful at best. A S]2k CoCoS with two Double sided drives, 40 or 80 
track is really needed. To boot OS-9 frofii the disks distributed by Tandy (35 track, single sided format) a 35 tr. 
or 40 tr, single or double sided drive, as Drive (DO) will be needed. CoCu/0S9 will support three floppy drives. 
The disk controller imposes this li^it, not DS-9. 

The terffis "boot" or "bootstrap", by a long standing convention, are siiiiply the tersis used for starting up an 
operating system on a cofDputer. 

After only a little use of OS-9 it will be noted that the systeis is very disk intensive, That is, the system 
accesses the disk drives frequently for the coBgands end files it needs to perforif: the requested tasks. Frequently 
used cofitsand soduies can be loaded into aesory to reduce disk access and speed things up, but, once again, sore on 
that later. 

An RSDDS disk has only one directory (stored on track 17) and all files stored on the disk are recorded in this 
directory, while an OS-9 disk can have B^.any directories and many levels. "Levels" there is a new concept. OS-9 
uses a hierarchal directory systei, and it is very letportant to understand this concept. Huch like a family tree 
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or soffletiaes described as an upside down tree with its "root" at the top. To get to any branch of the tree ye msi 
start froB the "root" 

The Root directory on a disk could be called the highest level, or referred to as the first level accessed. It 
does not have a naae as such. Tc see the contents of the "root" directory of a disk in drive 0, type "dir /dO", 
if the disk were in drive 1, type 'dir idW The root is the first directory read by the device. 

The next aost ifftportant concept to understand about disk files is the '^fay OS-9 uses TUG directories in its 
operation the DATA directory and the EXECUTION directory. 'Jhen OS-3 is booted, the data directory defaults to /dO 
and the execution directory defaults to /dO/CHQS (this assuraes that GS-5 is booted frois the floppy drive 0). The 
execution directory "CHDS'" contains executable niodules ^^hich my be systes titilities or prograa laodyies. ^hen a 
coeiaand is entered at the 0S9; prorapt, OS-3 will first look in aeisiory for a -sodule naie itfhich fsatches and if no 
"natch is found it sill look in the current execution directory and lastly will look in the current data directory. 
Once OS-9 finds the uiodulej it will attespt to execute thai Midule if in leaory, or will load the sodule froi disk 
and then execute it. 

Perhaps the ssost coaion error reported by OS-3 is ERROR 2i6 (Path Nao^e Hot Found). 

This error say sean that the file or ^aodule" that has been asked for; either froa the keyboard or another prograa, 

does not exist, OR, acre coffiaonly; the file does not exist in the current DATA or EaEC'JTION directories. 

Now the DATA and EXECUTION directories need not regain pointed to /dO and /dO/CMDS as these can be changed to any 
valid (existing) directory. eg. chd /dO/CHDS would change the current DATA directory to the CI^S directory on 
Drive 0. Yes, the data and execution directories can be pointed tc the saie directory. The DATA directory is also 
often referred to as the y'ORKINS directory (the sase directory by a different narie) The cosiand pyo or pwd will 
i-epori the current wORKINS or DATA directory. 

yhat is 3 "pathname"^ Files or nodules which are not in the current directories aay be located by OS-3 if the 
correct "pathnafse" is given. "Fathnase" is simply the -'path" in the directory or tree structure, eg. the coiaaand 
line list /dO/SYS/errssg would work provided the file "errssg" was in the directory SVS which is at 'root" level 
on the disk in 00. 

OS-3 assumes that any filenarse entered at the 0S3; prospt is an executable aodule. It first looks m iseiaory for a 
module of that nase, if not found, it will look in the current execution directory, and if not found, it will look 
in the current data directory, if not found, yill report ERROR 1218. 

Notice that QS-3 is not 'case sensitiveS cn^sands entered m lower case are treated identically to cos&sands 
entered in upper case. This also applies to file nases ana directory nases, however oy convention, uoper case 
should be used for all directory and sub-directory naisies, and lower case used m naRies of all single files within a 
directory. This convention isakss it easy to distinguish between directories and files, eg The rooi directory of 
disk 1 of the level 2 distribution disk looks like this ;- 

Directory of /dO 

■j-j J L.--JU I- \ji\'j V ■-' I •-' 3 L- a r vU U 

window. tSSs window. tSOs window. glr4 fflakecopy 

yith the exception of 'QS9Boot% a special OS-3 file; we can tell at a glance that "CnDS" and "SYS' are the only 
two directories at the ^root" level. Each of the others is a single file. 

OK. "Getting Started^ Chapter 2 (pages 2.1 - 2.5) gives all the necessary instructions to 'boot" QS-9. At the 
"Tiae^^ proiapt enter the date and tiiae, do NOT just hit (Enter) as the tiae is iaportant to the operating system. 
One short cut is to leave out the deliiaiters. eg 3004GI213G works just the saae as 30/04/01 21:30. Two digits 
raust be used for each ite-s. 04 for the fourth irionth, NOT 4, 

Assuiing that OS-3 has booted O.K. we now have the operating systea running with the default (as distributed) 
hardware descriptions. If this does not suit the capabilities of hardware connected to the systes we aust set 
about correctly describing the "devices" to OS-3. 'Je would also like to sake these descriptions peraanent so thai 
when the operating systei is booted, the correct descriptions will already be in place. 
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■■Geiiinn Started'' Chapter 7 (fro^ Dao9 7 i) uiv85 all the detailed inetructions. The floDDV drive descriotors to 

Miih the HAXIHUn canabilities of the system'; drives should be selerted. OS-S is sfiart enouoh to read and ^^rite 

to floDDv disks of any lesser caoacitv. For exaj^plt: the oescriDtor for an SO track double sided drive as Drive i 

v^ouid be Dl SOD, Once the systeiB is booted ?^itn this oescriDtor included in the OSSBoot file; Drive 1 i^ould 

h *. r-, r, i "( ■- ; - ^, •, A j — , •"• i-j r " ^ G * ■"• Z ■•:■:.-'. f "i P f-i j *■ 7 i '"^ j C :^ f i • 7- j i" i-" i*i Ti i : i"! ' li C " "i CI i"! C " Tt H i a C T t"! G H fi P ''-- ^ r- Zi r i' "i "i i ■ i~- ^ ij -l^ 1 •"" d "i C • ri - 1 - 

ildJDiiv ! i-iU dilij W! i .-c vL' c ijizr ! U ' liid '-■ L'tr'^ dz 4v vfc-l!. U-JL-Ji-r riJtr-j; siNUic liUtU Uii 'JJ i-l m. 'J'JL-.i.- i^ z-iuc^ji Zi-iUiz 

Sided . 

Do not include the descriptor Tl (it yon't ^ork very well on the CoCoS). 13 is probably not such use either, so 
don't include this one. Hi and 112 are for the Tandy Hcde=; Pak, not sold in Australia to kv knoif/ledoe, so leave 
these out also. (Note, the Tandy RS232 Pak is not the saii-e as the Hode^ Pak.) 

Include all the window descriptors w. yi - U7 (S12k systet^ assufsied) and a iFJULL coffii^and set. Confiq v^ill create 
a bootfile; 0S5Boot even if [Nju cosi^ands hve selected, however as a iiiiniau^ii for a bootable disk it iiiust contain a 
CnDS directory which contains the sodules ''Shell" and "GrfDrv". Actually "GrfDrv'^ is only required if windows are 
used, and of course QS-9 Level 2 windows are the key to useful i^ultitasking. 

It sav be noted that a drive descriptor for an 80 track double sided drive as Drive is not included in the drive 
selections. Should such a descriptor be needed, we can show you hoy to ii^ake one, or eore correctly, we can suddIv 
a '-patch' for one of the existing descriptors which will convert it to suit. 

Once a new "Boot" disk is created: the OS-S operating systefn will be running and all hardware in the systei ^ill oe 
fully available for the apoiication progras^fiies and Rulti-tasking that s^ill follow. 

The "config" prograjiisoe lalls OSSGen to create a bootable disk. uSSGen n/iil write the "Kernel" on trails Si of a 
floppy disk as wfell as create the OSSBoot file. Because the Kernel sust be in a specific location on the disk, and 
the OSSBoot fifust use contiguous sectors^ it is best to use a freshly foreiatted disk as the destination disK tor 
confio. Chaoter 1 of the "035 Cofs^ands" section beoins yith a descrintion of the "Kernel" nodule and describes 
other igiportant ^sodules. 

Do not expect too ffiuch at this point. Reiseaber that OS-5 is not a prograiii, it is an operating systeiii under which 
isany prograssing languages can be used. Basic05 (a for^i of Basic), pascal: C: Assembler, Fourth, and Logo to nase 
a ii'4. 

Next feonth we will begin to explore so^e of the iRulti-tasking abilities of DS-9. Please let fee know if you are 
having any difficulties in creating a Boot to suit your system. 

Gordon Hentzen 
00 GO G DO 00 o oo o oo o o o o 

Additions and Alterations. 
By Bob Devries. 

Those of you who typed in last sonths listing of 'CCSSo' could have run into trouble if you did not have the 

correct definitions file. It was pointed out to ffte by a local Brisbane user, that not all users out there have the 

newest version of the definition file 'OSSOefs'. The version I use casie fros^ the Developusent System disk (side B). 

it has the defs file that was SHodified for use with OJ? Level II. For those of you who do not have this file, two 
changes need to be Biade to the 'CC36o' listing. 
Both changes i^ay be sade at the beginning of the file, say at line 7, and you should add these lines :- 

D.SysPrc eou $4A 
D. Crash equ $GB 
Please note, that when you asseinble this file, you'll get a U warning giessage at the line that has the 'jsp 
D. Crash' in it. This is because it is illegal in norfiial 033 proqraSi&Mng to use a imp instruction or any otnar 
direct RieKory access instructions. In this case, however, OSS has crashed anyhow, so it no longer liiatters. 

i^hiist I ais writinc about chanoes to definitions files, there is another one that needs chanoino. That one is the 
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jes 1 (iz:; t."^ UUULiI 



#d8t IFIB F NHlINK '-2 

idefms F VIRQ 0--1" 

idef ine F SCHDIR 0- :1 

define FJLHRAH / E: 

^define SS_ALFAS ■■:;■■ 

^define SS CURSR 0a2S 

sd^finE SS AAGBF O'cO 

ii ! r ' ^" r- vj ~. ^' ^' ^' *' ~f J 

Soefms :^5_ii^\3^b uxd^ 

Idefine S3 UNSET O..S^ 

^define SS HHSEL •S:' 

tdefme SS SBAR 0\^:' 

Idefine SS_nGUSE O'-'E? 

tdefine SS^HSSIS 0/Sd 

ii 1 r * *". .-» A r» r. rv 1 1 ^ ,-■ i 

tdefine SS DSCRN 0\Sc 

IdefiTiH SSJSCRN OvSd 

Idef me SS PSCRN 0;:oc 

td&iine SS_FALET 0:"3" 

ftdefir!8 SS MONTR 0;.SI 

idefine SSJCTYP ^9? 

idef ine SS GIF 0"-^- 

tdefine SS UHEAR S?r 

toefine SS'OFPAL 0x97 

tdefine SS'tQNE OxSS 



!% CoCo Non gi3DDing Link 
it CoCo Non ffiaDpinq Luad 



: =■ ■-• -2. i 

■I M 



L-Li; li 



i yirect. 



Aiohd DibDldV Si-aiub (CoCo SCF GeiSiat) i/ 



!% Cursor Inforsiaiion for CoCo ^7 

1% Return screen size for CoCo %/ 

/•^ 6et/PuiSiat for CoCo Keyboard ^7 

fX £et7PyiStat for Baud/ran Iv ^7 

It PuiSidi to Allocate additional graphic Duffer t/ 

1% PutStai to select a different buffer i/ 

it Set/PuiStat to reouest buffer to be maoped to the «iorkspace 17 

It Set up high level windowing infor^iation +/ 

/* Reouest hioh level wmdoy handler to deterniine next event ^7 

/:;; PutStdt to position window scroll bars tf 

/^' Return Riouse inforfuation packet (CoCo) +/ 

It PutStat to tell driver to send signal on Eitouse event tl 

/% Allocate a screen for aoplication ookinq %i 

It Display a screen allocated by SS_ASCRN tl 

1% Free a screen allocated bv SS ASCRN tl 

It PolyisorDh screen into a different screen tvoe 1/ 

It Return Palette information tl 

It Get and Set ajonitor type 1/ 

It Get screen type inforiation tl 

It Global Input Paraiseters tl 

It nr.H:;ifi Nc-n'-J K--r- CciiQf^t XI 

It Return Colour reoisters GetStat tl 

It Set/Return default palette registers 11 

It Generate tone usmo S-Bit sound tl 



ooooooooooGOOOOCOOOOoooooooooo 

Finding inforKiation about your files. 

Ey Bob Devries. 

For a long tiie now. I have wanted to find out the details of the data stored m the file descriptor sector of i^y 
files, and not Just the modified date, starting sector, and length as 'dir e* reports it, yell, I thought that 
rather than buy a prograssie, it would be easier and (nore educational to write sy own. So here it is. Type it in, 
and ccEipile it, and you'll own a very useful tool for your OSS toolbox. 

To use fileinfO: either type 'fileinfo file', where file is any 0S5 pathnafne; or pipe the output of a prograsiBe 
like 'Is' or 'd' to it like thisl- 



Is 1 filemfo -i 

It FileInfo,c - by Bob Devries XI 

It Find file header information tl 

linclude <stdio.h> 

^include <direLt.h> 

iinclude <059.h> 

FILE :|:fp: ifopenO; 

-•t'"uc t f i 1 !"!es de^*" I 

aainfarqc.argy) 

int arnc; 

char Uf^U: 



too uevnea 
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ini 3 POD I 






cnap ^euiiv{): 

zhif f ileridoitiSOi; 

pMinitO; 

if (argc— <2) ( It check if iht right parauis are psised %l 

Dui5( ''Usaqs; fiieinfo file [file] ..."); 

putaC- or: fiieinfo -i to ijse stdin''); 

exit(O); 



if ((argv[]][0] == '-') hh (iounper(argvLi jlI j) == 'Z')) 

piped = TRUE: iX ~z parats so use read stdin for fiienaKieb +/ 

do ( 

btrLpyiatir/'dse^rewrM: 

I f f M i nnd ) f 

if ( ( f QeiBl f i lerta^e^SO.sidin) ) == NULL) { It read eidin 1/ 
Diped = FALSE: 



f iienaf^e[5trlen(f ilena&e)-] J = '\0M 1% remove CR char froni naiiie t! 
J else { 

5ifcpy(f iienafne.argvLdrgplr]); /+ if not sidin use coiiii^and line parafftB tl 

if ((fp = fopeii(f ilenase/'?")) == NULL) ( 1% try to open filename a5 a file tl 
if((fp = fopenffiienafne.'d'')) == NULL) ( /% if that fails, try directory read %/ 
fprintf (5tderr/\nCan' i open l5\n%f ilenajiie): 1% else reoort failure tl 
aroptr++j 
continue; 
3 
i 
if ((fseekifpjOl ,2))== -1) /+ seek to end of file %l 

fprintf(stderr, "Something wrong! Can't find end of file IsAn'Sfiienasie): 
po5 = fteli(fp); It get nuf^ber of chars in file 1/ 
printf('\nInfo on file 2s.\n%f ilenafsie); 

printf('\nOSS reports that file is lid {%%U) bytes lo^g.\n^pos,pos); 
readfdO; It read file descriptor sector tl 

printf ("\nFile descriptor inforiGation follows ;\n\n"); 
DfintfCFile attributes are : §s.\n\qetattr(attr,de5C-fd_atl)); 
printf{"File owner is l^sAn^descfd oyn==0 ? "SuperUser" ! utoaidesc.fd ownjS)); 
printfC'File was last updated on *02d/S02d/*02d at 
*02d:^02dAn%ne5c Jd_dateL0],desc.fd_date[]],desc.fd_date[2],de5c.fd_datei3j,desc.fd_d3te[4]): 
/+ the previous 2 lines should be typed in as one line tl 
printf("File link count is ^d. \n%ntsc.fd_link); 
printfCFiie size is >ld. \nVdesc.fd_fsize); 

pnntfCFile was created on ^02d/^02d/^02d.\n\de5e.fd_dcr[OL desc .fd_Gcr[ 1 1,de5C.fd_dcr[21); 
ptr = elsn; 

for(i=0; i<48; i+t) { l% print segifient list +/ 
13tol(ptr,desc .fdseqii] .addr, 1 ); 
if(lsn) ( 

printf("U5ed lu Is, starting at LSN %\q (JHa). in^^descfHsegii]. size, (desr.fdsegLiJ. size > )) 
"sectors" ; "sectorMsnjlen); 
It the previous 2 lines should be tvoed in as one line tl 
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f 1- ^ n : 



■cfGl) \\ ^DiDBdJ.'i Jt £nd coniinue 



cnar ^tutOdinufiiDer; string; f% unsignea 
unsioned nufiib^r: 
char sirinsDi]! 



11 convsriicn 



h R itoaO function t 



1 ! i V i , 

number = -number; 



birinQ[i-i-+j = number I 10 ■*■ '0 
] while (inuEiber /= 10) > G); 
if (bign < 0) 

5tringLit+] = '-'' ; 
BirinoLii = '\0' ; 



jverssCsiring) ; 
iturnCsirino) = 



char 5[]; 
{ 



ini C: 1, j; 

for (i=Oj j=sirlen(5)-] :i<j : i+"; J — ) 

SLiJ = siil: 



1 

cha? JgHiat.ir(atir,byi-e) fX fros a ai-tribuie byi9: return a siring \vith chars set or ■-' +/ 
char dttrLl; ft e.a. — e^rewr ?/ 



int i, ], k: 

for (i=0: j = 12S; i<S;i+-i-, j/=2) { /I msi use j/=2 here NOT >> because of siqn extension 1/ 



1% if bit not setj insert a ■-' char %I 



- J. i _, r : T _ ! I I 
it-tfllj - - ; 



return(attr); 
} 
readfdO /+ read the file descriptcr sector into the structure, using the 6ETSTT SS_FD call %l 

! 

L 

struct registers regs; 

rec5.rq_a = fiieno(fp); 1% a = path nuffiber %l 
regs.rq^b = SS_FD; 1% b - function nutiiber Xi 

regs.rg^x = adesc; IX y. - address of ^ieffiory packet Xi 

reqs.rg_y = sizeof (desc);/^ y = nufisber of bytes of packet XI 
regs.rg_u = 0; 
os9(i GlTSTT Jreas); It. didn't check for errors here, if error, OSS fsust have crashed %l 
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